home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 2.toast / pc / sample code / quicktime / all java / quicktime for java / soundrecord / readme.txt next >
Encoding:
Text File  |  2000-09-28  |  3.0 KB  |  61 lines

  1. =============================================================================
  2. QuickTime for Java SDK                              Updated: 30 November 1998
  3.  
  4. Read Me Notes to "Sound Record" Demo and Sample Code
  5.  
  6. =============================================================================
  7. This code shows using the SequenceGrabber for simple audio recording
  8.  
  9. =============================================================================
  10. The minimum runtime requirements for this Sample Code are:
  11.  
  12. - Common
  13.     - Sun Compliant Java Runtime Environment 1.1
  14.     - QuickTime 3 
  15.     - QTJava.zip
  16.  
  17. - MacOS:
  18.     - System 8 or later
  19.     - Macintosh Runtime for Java (MRJ) 2.1
  20.  
  21. - Windows 95, 98, or NT::
  22.     - JRE/JDK from Sun Microsystems, Inc. recommended
  23.  
  24. =============================================================================
  25. No media requirements for this Sample Code.
  26. =============================================================================
  27. Notes & Comments
  28.  
  29. Settings - allows the user to specify the source, compression and format for the recording
  30.  
  31. Record - create a file to save the recorded information in and start recording
  32.  
  33. Stop - stop recording and show window with movie in it
  34.  
  35. You need to dispose of your connection to the Audio Channel before playing back the recorded sound, (otherwise you won't hear your recorded sound). This is a limitation of the Windows sound architecture.
  36.  
  37. It is important that your code call setDataOutput() before any other sequence grabber call's e.g prepare(). Failure to do so will result in your program silently aborting.
  38.  
  39. You do not need to create a moviefile to save the recorded data as the sequence grabber will automatically create a movie file for you based on the file you set in the setDataOutput method.
  40.  
  41. It is important to note that the Java Garbage Collector may hold onto previously created files, and not
  42. free them up when expected. The call QTUtils.reclaimMemory() in the SoundRecord.java code
  43. signals the garbage collector to run, however this is not a guarantee that the GC will immediately be invoked.
  44. The side affect of this behaviour is that you may occassionaly see a message that a file is use if you try to save a
  45. recording the second time using the same filename.
  46.  
  47. =============================================================================
  48. General Comments
  49.  
  50. - QTSession.open and close:
  51.  
  52. A QTSession.open will perform a gestalt check to ensure that QuickTime is present and is initialized. This is a required call before any QuickTime Java classes can be used.
  53.  
  54. When the user closes the window the program will quit, first calling QTSession.close to terminate QuickTime. It is necessary for programs to call QTSession.close if they have previously called QTSession.open in order to shut down QuickTime properly.
  55.  
  56.  
  57. =============================================================================
  58.  
  59. QuickTime and QuickTime for Java are trademarks of Apple Computer, Inc.
  60. (c) 1998 Apple Computer Inc. All rights reserved.
  61.